home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-02 / oasis.zip / README.2ND < prev    next >
Text File  |  1989-12-05  |  10KB  |  305 lines
  1.                  ╔════════════════╗
  2.                  ║  Introduction  ║
  3.                  ╚════════════════╝
  4.  
  5. The information contained in this file is relative to OASIS
  6. Version 5.0. OASIS 5.0 is upwards compatible with all earlier
  7. versions, i.e programs and screenfiles generated with earlier
  8. versions of OASIS can be used with OASIS 5.0 without any
  9. modifications. 
  10. The main difference between OASIS 4.x and OASIS 5.0 is, amongst
  11. some new features, the fact that OASIS 5.0 is compatible to Turbo
  12. Pascal 5.x. 
  13.  
  14. Since the .TPU file structure is entirely different for Turbo
  15. Pascal 4.x and 5.x two different SCL.TPU files have been included
  16. on your disks: 
  17.             - SCL40.TPU  
  18.             - SCL50.TPU 
  19.             - SCL55.TPU
  20.  
  21. SCL40.TPU contains all SCL routines in Turbo Pascal 4.x format,
  22. SCL50.TPU & SCL55.TPU contains the one for Turbo Pascal 5.0 & 5.5 
  23. compilers. Apart from this, all files are identical. 
  24.  
  25.   
  26.    Depending on which version of Turbo Pascal you use, you 
  27.    need to perform the following additional step after you 
  28.    have installed OASIS 5.0 on your hard disk:             
  29.                                                            
  30.    If you use Turbo Pascal 4.x enter at the DOS Prompt:    
  31.    COPY SCL40.TPU SCL.TPU                                   
  32.                                                            
  33.    If you use Turbo Pascal 5.0 enter at the DOS Prompt:    
  34.    Copy SCL50.TPU SCL.TPU                                   
  35.   
  36.    If you use Turbo Pascal 5.5 enter at the DOS Prompt:
  37.    Copy SCL55.TPU SCL.TPU
  38.                                                                  
  39.  ╔═══════════════════════════════════════════════════════════╗
  40.  ║  Changes not contained in the manual (since version 4.0)  ║
  41.  ╚═══════════════════════════════════════════════════════════╝
  42.  
  43.                    ┌─────────────────────┐
  44.                    │   New SCL Features  │
  45.                    └─────────────────────┘
  46.  
  47. SCL.TPU: A exit Procedure has been added which restores the BIOS
  48. interrupt pointers taken over by SCL automatically whenever a
  49. program using SCL is getting a runtime error or the break key is
  50. pressed. 
  51. This exit procedure also closes all files used by SCL and makes a
  52. system reboot in such a case superfluous. 
  53. Three more procedures have been added which now allow screen 
  54. Attributes to be changed within SCL driven programs. This feature
  55. is especially useful if a program has to run on a system which
  56. translates screen attributes different to standard IBM
  57. conventions. For this purpose, a screen attribute translation
  58. table has been defined which is then indexed by the SCL screen
  59. driver routines.
  60.  
  61. The definition is: 
  62.  
  63. Var Screen_Color_Translation_Table: Array[0..255] of Byte; 
  64.  
  65. It is being indexed by the attribute byte and the corresponding
  66. entry then contains the actual attribute to be displayed, i.e
  67. Screen_Color_Translation_Table[OldAttr] contains the attribute to
  68. be displayed instead of OldAttr. 
  69.  
  70. Upon startup, SCL initializes all Colors to their default values.
  71.  
  72. Once SCL has been initialized, Colors/Attributes can be
  73. customised using the following new procedure and functions: 
  74.  
  75.  
  76. Procedure Reset_Screen_Colors; 
  77.  
  78. Resets all screen Colors/Attributes to their default values. 
  79.   
  80.  
  81. Procedure Change_Color(Oldattr,NewAttr:Byte); 
  82.  
  83. Once this procedure is executed, all occurrences of OldAttr will
  84. be translated to Newattr. 
  85.  
  86.  
  87. Function Get_Current_Color(Attr:Byte):Byte; 
  88.   
  89. This function returns the value to which Attr is currently being
  90. translated. 
  91.   Furthermore   all  screen   display  write   routines  have  been
  92. completely redesigned. Major enhancements are: 
  93.  
  94. - A threefold speed increase for screen write operations 
  95. - No Snow on CGA monitors 
  96. - The automatic  detection of monitor types  has been enhanced to
  97.   include VGA. 
  98.  
  99.  
  100. The SCL routines DC, Draw_Char and Set_Att have been removed from
  101. SCL. Instead,  the  following  (primarily   internally  used  by 
  102. SCL) procedures were added: 
  103.  
  104.  
  105. PROCEDURE WriteT(Txt:String;X,Y:BYTE); 
  106.  
  107. This Procedure writes Txt to the screen, starting at column X and
  108. row Y. The Display attribute remains unchanged. 
  109.   
  110.  
  111. Procedure WriteA(Count:Word;X,Y,Attr:Byte); 
  112.  
  113. This Procedure changes the screen  attribute to Attr, starting at
  114. column X  and Row Y  for Count Positions.  The Text displayed  at
  115. these positions remains unchanged. 
  116.  
  117.  
  118.  
  119. Procedure WriteTA(Txt:String;X,Y,Attr:Byte); 
  120.  
  121. This Procedure writes  Txt onto the screen, starting  at column X
  122. and Row Y.  The Display attribute for these  positions is changed
  123. to Attr. 
  124.  
  125.  
  126. The  routines to  detect the  Display adapter  and Monitor in use
  127. have been enhanced as follows:  
  128. The variables Color_True and  Mono_Adapter have been removed from
  129. SCL. 
  130.  
  131.  
  132. A new TYPE definition has been added: 
  133.  
  134. TYPE Displaytypes = (MDA,CGA,EGA,MCGA,VGA); 
  135.  
  136.  
  137. Two new Functions have been added: 
  138.   
  139. FUNCTION Displaytype:Displaytypes; 
  140.  
  141. This Function returns the currently active type of display. 
  142. FUNCTION Videomode:BYTE; 
  143.  
  144. This  function  returns  the  currently  active  Video Mode. This
  145. function is used SCL internally and  should not be called by user
  146. programs.  Use  the  contents  of  the  Variable 'Screen_Mode' as
  147. described in the manual instead.  If for example  you want to
  148. know whether  you are currently using the monochrome mode you
  149. could use the following statement: 
  150.  
  151. Mono_Active:=(Screen_Mode=7); 
  152.  
  153.  
  154.  
  155. A new function has  been added to SCL which  allows user programs
  156. to check whether the printer is ready and online or not: 
  157.  
  158.  
  159. FUNCTION Printer_Ready(Result:BYTE):BOOLEAN; 
  160.  
  161. This function returns the current status of the parrallel printer
  162. connected to  LPT1:. Note that it  cannot be used to  inquire the
  163.  
  164. status of a serial Printer. 
  165. 'Result' can have the following values: 
  166. 0: No Error 
  167. 1: Printer not powered on 
  168. 2: Printer is out of paper 
  169. 3: Printer is offline 
  170.  
  171.  
  172. Example: 
  173.  
  174. If not Printer_Ready(Res) then 
  175.   begin; 
  176.     case Res of 
  177.       1: Msg('Printer power off'); 
  178.       2: Msg('Printer out of Paper'); 
  179.       3: Msg('Printer Offline'); 
  180.      end; 
  181.   end; 
  182.  
  183.   
  184. Progpath: 
  185.  
  186. The variable "ProgPath" (see Manual) is now initialized at
  187. program start, not by a call  to "Select_Format_File" as
  188. described in the Manual.  If  left  unchanged,  "Progpath" 
  189. contains  the complete directory path, inluding drive 
  190. identifier, which was active when the program  using SCL has 
  191. been started. Progpath is used by SCL to  indicate from which
  192. directory the SCL Files should be loaded. By loading a new Path 
  193. description into "Progpath" before calling "Select_Format_File"
  194. you can now specify  from which path the SCL files should be
  195. loaded. Example: 
  196.  
  197. BEGIN; 
  198.   Progpath:='C:\Mydir\'; 
  199.   Select_Format_File('Myformats'); 
  200.   ....... 
  201. END; 
  202.  
  203. In  the  above  case  SCL  would  look  for  'Myformats'  in  the
  204. Subdirectory '\Mydir' on drive C:  , independent of the currently
  205. active drive and directory. 
  206.  
  207.  
  208.  
  209.                    ┌──────────────────┐
  210.                    │ New SFD Features │
  211.                    └──────────────────┘
  212.  
  213. File Import: 
  214.  
  215. A new option has been added to  the SFD Main Menu which allows to
  216. import existing Format Layouts from an external file into SFD.
  217. Note that this feature is only available in OASIS/SFD
  218. Professional.  The layout of the external file  from which the
  219. formats are to be read must be as follows: 
  220.  
  221. TYPE 
  222.   Screen=ARRAY[1..25] of string[80]; 
  223.  
  224. FILE 
  225.   ImportFile=File of Screen; 
  226.  
  227.  
  228. The 'File  Import' function reads  all records from  the file and
  229. converts them  to OASIS compatible Screen  Formats which can then
  230. be edited with SFD. The formats will be named as follows:  
  231. FFFFFFFNNN where  FFFFFFF are the  max 7 first  characters of the
  232. name of <Import  file> (without extension) and NNN  is the record
  233. number  within <Import  File>, starting  with 001  for the  first
  234. record. 
  235.  
  236. Example: 
  237.  
  238. If we would import formats  from a file called 'Myfile.Dta' which
  239. contained 3 records, they would  be named as Myfile001, Myfile002
  240. and Myfile003. 
  241.  
  242.  
  243. Note:  
  244. Screen  formats   originating  from  other   programs  often  use
  245. different  characters as  Field Delimiters.  In order  for SFD to
  246. recognize  these  delimiters  you  the  SFD  defaults must be set
  247. accordingly in 'Design Defaults'. 
  248.  
  249.  
  250. New Command Line Option for SFD: 
  251.   
  252. SFD can now be started with a command line option as follows: 
  253. SFD   P=<Path>  
  254. <Path>  must  be  a  valid  DOS  Path,  with  or  without a drive
  255. identifier. If  started in this  way, SFD will  load its internal
  256. files from the directory indicated by <Path>.  This new option
  257. allows SFD to be started from any directory. If SFD is  started
  258. without a command line  option, it will expect its internal files
  259. in the currently active directory.  If an invalid command line 
  260. option is specified, SFD will display a help message and then
  261. terminate. 
  262.  
  263.  
  264. "SNOW" on old Color Graphics Adapters: 
  265.  
  266. An automatic detection  for CGA adapters has been  added which is
  267. used to  switch on a special screen write mode. SFD does
  268. therefore not anymore  produce "Snow" if used on systems with an
  269. old type CGA adapter. 
  270.  
  271.  
  272.              ┌──────────────────────────────────┐
  273.              │  Errors Fixed since Release 4.0  │
  274.              └──────────────────────────────────┘
  275.  
  276. SFD: 
  277.  
  278. A bug has been fixed in SFDs 'Print Format' routine. Now the
  279. correct field messages are listed in all cases. 
  280.  
  281. Some left  over debug code has  been removed which caused  SFD to
  282. print some superfluous stuff on  the printer while a workfile was
  283. being  opened and  which caused  SFD to  terminate with a runtime
  284. error  in case  the printer  was not  ready while  a workfile was
  285. being opened.   
  286. Some minor errors in SFD help formats have been corrected. 
  287.   
  288. The  overall  execution  speed   of  SFD  has  been  considerably
  289. increased. 
  290.  
  291. COMPAQ and VGA adapters and screen modes should now be recognized
  292. and handled correctly. 
  293.  
  294. A minor  problem  where  the  cursor  was  positioned outside the
  295. drawing area in the SFD Format  Designer after a call to the menu
  296. has been fixed. 
  297.  
  298.  
  299.  
  300. SCL: 
  301.  
  302. A bug with High Priority Background Tasks has been fixed.  
  303. COMPAQ and VGA adapters and screen modes should now be recognized
  304. and handled correctly. 
  305.